Skip to content

Update help site: document bulk expense duplication#87569

Open
MelvinBot wants to merge 1 commit intomainfrom
melvinbot-helpsite-bulk-duplicate-84657
Open

Update help site: document bulk expense duplication#87569
MelvinBot wants to merge 1 commit intomainfrom
melvinbot-helpsite-bulk-duplicate-84657

Conversation

@MelvinBot
Copy link
Copy Markdown
Contributor

Summary

  • Updates docs/articles/new-expensify/reports-and-expenses/How-to-Duplicate-an-Expense.md to document the new bulk duplication feature added in [Duplicate Expense] Allow bulk duplication.  #84657
  • Adds a new "How to duplicate multiple expenses at once" section with step-by-step instructions
  • Corrects the FAQ that previously stated bulk duplication was not supported
  • Updates metadata (description, keywords, internalScope) to reflect bulk duplication coverage

Related PR

#84657 — [Duplicate Expense] Allow bulk duplication

Test plan

  • Verify the help site article renders correctly at the expected URL
  • Confirm the new bulk duplication steps match the actual UI flow
  • Confirm the FAQ answer is accurate

Updates How-to-Duplicate-an-Expense.md to reflect the new bulk
duplication feature added in #84657. Adds a new section
with steps for duplicating multiple expenses at once, and corrects the
FAQ that previously stated bulk duplication was not supported.

Co-authored-by: Krishna <Krishna2323@users.noreply.github.com>
@github-actions
Copy link
Copy Markdown
Contributor

HelpDot Documentation Review

Overall Assessment

This PR updates the "How to Duplicate an Expense" article to document the new bulk duplication feature. The changes are well-scoped: updated metadata, a new procedural section for bulk duplication, and a corrected FAQ answer. The additions generally follow governance standards with a few items worth addressing.

Scores Summary

  • Readability: 8/10 - The new section is clear and action-oriented. Steps are sequential and concise. Minor clarity issue: step 3 mixes eligibility criteria into what should be a selection action ("cash, distance, or per diem expenses that you submitted" adds conditions mid-step that could be separated into a note).
  • AI Readiness: 9/10 - The new ## How to duplicate multiple expenses at once heading is task-based, searchable, and includes the feature name. Updated keywords and internalScope accurately reflect the expanded coverage. YAML metadata is well-maintained.
  • Style Compliance: 7/10 - There are two naming/reference concerns in the proposed changes that need attention (detailed below).

Key Findings

Issues in the proposed changes:

  1. "Reports > Expenses" navigation reference (new section, step 1): The step reads select **Reports > Expenses**. Verify that Reports > Expenses matches the exact UI tab path. The naming conventions governance requires using the exact text shown in the product UI with no paraphrasing or shortening. If the UI shows an Expenses tab directly (not nested under Reports), the reference should be corrected.

  2. "bulk actions dropdown" is not bolded or UI-exact (new section, step 4 and FAQ): The phrase "bulk actions dropdown" appears twice in the proposed changes but is never bolded. Per the Button Naming Standards and Section/Toggle References in the naming conventions, clickable UI elements should be bolded with their exact UI label. If the UI shows a specific label for this dropdown (e.g., Actions or Bulk actions), it should be referenced exactly and bolded.

  3. "Open the bulk actions dropdown" phrasing (new section, step 4): The phrase "Open the bulk actions dropdown" could be considered borderline prohibited language ("Open the menu" pattern). Consider rephrasing to reference the exact UI element, e.g., "Select [exact dropdown label] and choose Duplicate expenses."

  4. Step 3 mixes action with eligibility criteria: "Select two or more cash, distance, or per diem expenses that you submitted" bundles eligibility rules into the action step. Consider simplifying the step to "Select two or more expenses" and noting eligibility restrictions separately (as is already partially done in the paragraph below the steps).

Positive aspects:

  • The metadata updates (description, keywords, internalScope) are thorough and accurately reflect the expanded scope.
  • The new section follows the correct heading hierarchy (## only, under the single # title).
  • The screenshot placeholder uses the correct HTML comment format per governance.
  • The FAQ correction from "No" to "Yes" with clear instructions is well-handled.
  • Navigation instruction in step 1 correctly uses the unified cross-platform format per naming conventions.

Recommendations

  1. Verify and bold the exact UI label for the bulk actions dropdown element. This is the most important style compliance fix.
  2. Simplify step 3 by moving eligibility criteria to a note or the explanatory paragraph that follows.
  3. Confirm "Reports > Expenses" matches the actual UI navigation path exactly.

Files Reviewed

  • docs/articles/new-expensify/reports-and-expenses/How-to-Duplicate-an-Expense.md - 25 lines added, 6 lines modified. New bulk duplication section, updated metadata, corrected FAQ. Generally well-structured with minor style compliance items to address.

Review based on governance files: docs/HELPSITE_NAMING_CONVENTIONS.md, docs/HELP_AUTHORING_GUIDELINES.md, and docs/TEMPLATE.md.

You can select multiple eligible expenses and duplicate them all in one action.

1. In the navigation tabs (on the left on web, on the bottom on mobile), select **Reports > Expenses**.
2. Long-press an expense (or use the checkbox on web) to enter selection mode.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Naming and style / Prohibited language: "Open the bulk actions dropdown" uses vague navigation phrasing. Per HELPSITE_NAMING_CONVENTIONS.md, avoid generic references like "Open the menu" — instead reference the exact UI element label in bold. If the dropdown is triggered by a specific button (e.g., Actions or a named button), use that exact label. Similarly, "choose" should be "select" to stay consistent with the conventions (which use "Select" as the standard verb).

Suggested fix: Replace with the exact button/menu label, e.g., Select **Duplicate expenses** from the **Actions** menu. (adjust to match the actual UI label).

## How to duplicate multiple expenses at once

You can select multiple eligible expenses and duplicate them all in one action.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Naming and style / Navigation instructions: Per HELPSITE_NAMING_CONVENTIONS.md, when web and mobile navigation differ, provide separate labeled instructions — do not merge them into one sentence with parenthetical qualifiers. "Long-press an expense (or use the checkbox on web)" describes different interactions per platform and should be split:

**Web:** Select the checkbox next to an expense to enter selection mode.
**Mobile:** Long-press an expense to enter selection mode.

## Can I duplicate multiple expenses at once?

No, you can’t duplicate multiple expenses at once. Expenses must be duplicated one at a time.
Yes. Select two or more eligible expenses from the **Expenses** tab or from within a report, then choose **Duplicate expenses** from the bulk actions dropdown. Each selected expense is duplicated individually with the same rules as single duplication.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Naming and style / Prohibited language: "from the bulk actions dropdown" uses a generic, informal reference. Per HELPSITE_NAMING_CONVENTIONS.md, always reference the exact UI label. Replace "bulk actions dropdown" with the exact name of the menu/button as it appears in the product UI, bolded (e.g., Actions).

description: Learn how to create a copy of an existing expense in Expensify using the Duplicate option.
keywords: [New Expensify, duplicate expense, copy expense, duplicate cash expense, duplicate distance expense, duplicate per diem expense, create copy of expense]
internalScope: Audience is expense submitters. Covers how to duplicate a single cash, distance, or per diem expense. Does not cover duplicate detection, resolving flagged duplicates, or merging expenses.
description: Learn how to create a copy of one or more expenses in Expensify using the Duplicate expense option, including bulk duplication from the Expenses tab.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI readiness / Metadata alignment: The YAML description still says "an existing expense" in "Learn how to create a copy of one or more expenses" but the original description on the base branch says "an existing expense." The updated description looks good overall but note it says "using the Duplicate expense option" — verify this matches the exact UI label. If the button says Duplicate expense (singular), then "Duplicate expense option" is slightly off since it appends "option." Consider: Learn how to create a copy of one or more expenses in Expensify using Duplicate expense, including bulk duplication from the Expenses tab.

1. In the navigation tabs (on the left on web, on the bottom on mobile), select **Reports > Expenses**.
2. Long-press an expense (or use the checkbox on web) to enter selection mode.
3. Select two or more cash, distance, or per diem expenses that you submitted.
4. Open the bulk actions dropdown and choose **Duplicate expenses**.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Readability / Clarity: This sentence packs too many exclusion conditions into one clause, making it hard to scan. Consider using a bulleted list for the exclusion criteria:

The same rules apply as for single duplication. The following expenses are excluded from bulk selection:

- Card expenses (company cards and Expensify Cards)
- Expenses with receipts currently being scanned
- Per diem expenses without start or end dates
- Expenses you did not submit

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 855d562d52

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

## Can I duplicate multiple expenses at once?

No, you can’t duplicate multiple expenses at once. Expenses must be duplicated one at a time.
Yes. Select two or more eligible expenses from the **Expenses** tab or from within a report, then choose **Duplicate expenses** from the bulk actions dropdown. Each selected expense is duplicated individually with the same rules as single duplication.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Clarify that bulk duplication is not production-available yet

This answer now says bulk duplication is generally available, but the app still hides the action in production builds: both bulk-entry points require !isProduction (src/hooks/useSearchBulkActions.ts:833 and src/hooks/useSelectedTransactionsActions.ts:171). As written, public help-site users in production will be told to use a bulk action that does not appear, so the doc should either mention rollout limitations or wait until the production guard is removed.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants